Living Lab
============

Description
-----------
This dataset contains sensor and energy consumption data that was collected in 14 student rooms of a KU Leuven residence hall, in Leuven, Belgium over 
a period of approximately 2 months. The files contain raw sensor events/energy measurements, no activities are annotated.

Each room is equipped with 2 multi-sensors, comprising a motion sensor, a temperature sensor, a digital light sensor and a relative humidity sensor or 
a door closure sensor. Furthermore, an energy meter was installed to measure the radiator’s energy consumption. Finally, the setpoints of the 
thermostatic radiator valve are logged.

All variables were collected event-based, meaning that a new reading was recorded only when the respective variable's value had changed, and have been
resampled to a 15-min resolution.


File structure
--------------
The folder named "energy" contains the energy consumption data for each of the 14 rooms.
Each file contains the following variables:

   Variable        | Description
   ------------------------------------- 
   date            | timestamp
   energy,Wh       | energy consumption in Wh

The folder named "sensing" contains the environmental sensing + setpoint data for each of the 14 rooms. 
Each file contains the following variables:

   Variable        | Description
   ------------------------------------------------- 
                   | timestamp
   M-T             | Temperatuur of sensor M
   D-M_LT          | Motion of sensor D
   D-SW_T          | Door closure of sensor D
   M-L             | Light level of sensor M
   R               | Temperature setpoint
   M-H             | Relative humidity of sensor M
   M-M_T           | Motion of sensor M
   D-SW_LT         | Door closure of sensor D
   M-M_LT          | Motion of sensor M
   D-L             | Light level of sensor D
   D-M_T           | Motion of sensor D
   D-T             | Temperature of sensor D

Note: X-Y_T and X-Y_LT (where X represents the sensor and Y either motion or door closure) both measure the same thing, but in a different way.
X-Y_T directly records the motion triggers, whereas X-Y_LT computes motion/door closure based on the timestamp of the last trigger.
 

Sensor layout
-------------
There are two types of rooms: single-space and double-spaced rooms. Rooms 1-4 and 8-10 are single-spaced rooms. Rooms 5-7 and 11-14 are double-spaced rooms.
The layout of the sensors in the office is shown in the files sensor_layout_single.png and sensor_layout_double.png.


References
----------
Please cite the related article in any publications resulting from using this dataset.

Y. De Bock, A. Auquilla, E. Bracquené, A. Nowé and J.R. Duflou: The Energy Saving Potential of Retrofitting a Smart Heating System: A Residence Hall Pilot Study